Obtains the current power state of a display.

OSErr DMGetAVPowerState (
    AVIDType theID, 
    AVPowerStatePtr getPowerState, 
    UInt32 reserved1
);

theID

The ID number of the display device whose power state you want to obtain.

getPowerState

A pointer to a structure of type AVPowerStateRec . On return, this parameter points to a value specifying the current power state of display device.

reserved1

Reserved for future expansion. Pass NULL in this parameter.

function result

A result code.

SPECIAL CONSIDERATIONS

Because this function may move or purge memory blocks or access handles, you cannot call it at interrupt time.

AVAILABILITY

Supported in Carbon. Available in CarbonLib 1.0 and later when DisplayLib 2.0 (or later) or DisplayLib68k 2.0 (or later) is installed. Exported by CarbonLib 1.0 and later, DisplayLib 2.0 and later, and by DisplayLib68k 2.0 and later.

© 2000 Apple Computer, Inc. — (Last Updated 3/8/2000)